'\" t
.\"     Title: IPSEC_PF_KEY
.\"    Author: Paul Wouters
.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/>
.\"      Date: 12/16/2012
.\"    Manual: Executable programs
.\"    Source: libreswan
.\"  Language: English
.\"
.TH "IPSEC_PF_KEY" "8" "12/16/2012" "libreswan" "Executable programs"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ipsec_pf_key \- shows pfkey messages emitted by the kernel when using the KLIPS or MAST stack\&.
.SH "SYNOPSIS"
.HP \w'\fBpf_key\fR\ 'u
\fBpf_key\fR \-\-ah \-\-esp \-\-ipip \-\-ipcomp \-\-daemon \fIfilehmac\-md5\-96\fR | \fIhmac\-sha1\-96\fR 
.SH "STACK"
.PP
Note that pf_key is only supported on the KLIPS and MAST stacks\&. It is not supported on any other stack\&.
.SH "DESCRIPTION"
.PP
\fBpf_key\fR
is a program to open a PF_KEY socket and print all messages that are received from it\&. With no options, it will register itself to receive key requests for AH, ESP, IPIP and IPCOMP security associations\&. If given more specific options, then it will listen only to those protocols which are listed\&.
.PP
If the messages are recognized, the messages will be decoded\&.
.PP
If the option
\fB\-\-daemon\fR
is provided, then after doing the registrations, the program will fork into the background\&. The provided file will be opened and the process ID of the background process will be written to it\&. This option is present to present race conditions in regression testing\&.
.SH "FILES"
.PP
/proc/net/pf_key
.SH "SEE ALSO"
.PP
\fBpf_key\fR(5),
\fBipsec\fR(8),
\fBipsec_manual\fR(8),
\fBipsec_eroute\fR(5),
\fBipsec_spi\fR(5),
\fBipsec_spigrp\fR(5),
\fBipsec_klipsdebug\fR(5),
\fBipsec_tncfg\fR(8),
\fBipsec_version\fR(5)
.SH "HISTORY"
.PP
Written for the Linux FreeS/WAN project <\m[blue]\fBhttp://www\&.freeswan\&.org/\fR\m[]> by Michael Richardson <mcr@freeswan\&.org>
.SH "AUTHOR"
.PP
\fBPaul Wouters\fR
.RS 4
placeholder to suppress warning
.RE
